home *** CD-ROM | disk | FTP | other *** search
- $Id: Present.txt,v 1.3 1998/11/25 15:46:48 dj Exp $
-
- Hyperceive plugin documentation
- ===============================
-
- Name: Present
- Purpose: Simple presentation system
- Author: James Aylett
-
- The Present applet provides a simple slide-show of presentation pages. The
- pages are images, and are displayed between a foreground and a background
- image. Action hotspots may be defined on the foreground layer.
-
-
- Parameters
- ----------
-
- backgroundcolour as r,g,b (default is black)
- backgroundimage <url>
- foregroundimage <url>
- <p>image the image for the current page
- <p>sleep time to sleep before starting
- the next page
- <p>x, <p>y offsets into image to display
- <p>shuntx x speed in pixels/clock to
- shunt the previous image
- <p>shunty y speed as above
- <p>shuntbump if present, bump shunt not smooth
- <p>shuntclock clock in milliseconds for the
- shunt
- <p>shuntsound URL of a sound file to loop
- during the shunt
-
- hotspot<n>url URL for hotspot number n.
- hotspot<n>target
- hotspot<n>x0 position of hotspot number
- hotspot<n>y0 n, defined as a rectangle
- hotspot<n>x1
- hotspot<n>y1
- hotspot<n>sound URL of a sound file to play
- when the hotspot is
- clicked on
-
- <p> is a page number, starting from 1. <n> starts from 1.
-
- If the sleep is -1, Present will enter a holding state at that point, waiting
- until Hyperceive 'plays' it. If not, it will wait for that time before
- proceeding on to the next page. The Hyperceive event c_play will move it on
- to the next page; c_playarg n will move it to page n.
-
- During the holding state, it will report itself as loaded and ready to
- proceed to Hyperceive; at all other times it will report 'still loading'.
-
-
- Operational flow
- ----------------
-
- The sequence of events is therefore:
-
- REPEAT (pages):
- shunt previous page off with new one
- prepare next page, if necessary
- wait for '<p>sleep', or wait for play / playarg event from Hyperceive
- UNTIL last page displayed
-